home *** CD-ROM | disk | FTP | other *** search
/ Easy Internet / Internet Training Corporation Easy Internet Rev21 (ITC).ISO / mac / DATA / stuffit.txt < prev    next >
Text File  |  1997-09-07  |  11KB  |  130 lines
  1. StuffIt Expander¬ Read Me
  2. =============================
  3. Copyright ⌐1992-1996, Aladdin Systems, Inc.
  4.  
  5. StuffIt Expander is copyrighted freeware software.
  6.  
  7. You should not run the software until you have read the document called ╥License Agreement╙. By running the software you signify that you agree to the terms of the License Agreement.
  8.  
  9. This document contains instructions which will aid your understanding of StuffIt Expander as well as explaining known issues and special topics that may interest you.
  10.  
  11. Register Your Software
  12. ---------------------
  13. If you have not already done so, please complete the StuffIt Expander Registration Form found in the ╥Read Us First!╙ folder. This will help us keep in touch with you about Aladdin Systems and our software.
  14.  
  15. Description
  16. -----------
  17. StuffIt Expander is designed to be the simplest, most efficient way to expand compressed files and encoded files that you may have received from the Internet, an online information service, bulletin board system, over a network, or from a co-worker.  StuffIt Expander handle the four most common compression and encoding formats, which are StuffIt¬ and Compact Pro¬ archives (.sit, .sea, and .cpt) , BinHex (.hqx) , and MacBinary (.bin).  Using StuffIt Expander will let you access the millions of compressed and encoded files you will find on the Internet and online services, or even those sent you by a friend.  
  18.  
  19. An archive is a single file which acts like a container, holding one or more files or folders. Usually the files in an archive are compressed, so they take up less room on a diskette or hard drive, and take less time to transmit over networks and modems. Unless the archive is ╥self-extracting╙ (.sea), you need a separate utility to access the files in an archive. StuffIt Expander is a utility which lets you decompress the contents of archives. All non-encrypted archives created by any version of StuffIt¬ and Compact Pro¬ are supported, including files created with other members of the StuffIt family, including StuffIt Deluxe, StuffIt Lite, or DropStuff. 
  20.  
  21. StuffIt Expander will also expand files which have been ╥encoded╙ in BinHex 4.0 (.hqx) format, such as those commonly found on the Internet. Multipart BinHex files, such as those appearing in Internet newsgroup postings (e.g. comp.binaries.mac), are fully supported. StuffIt Expander will also ignore any headers from BinHex files.
  22.  
  23. StuffIt Expander will also expand files which have been ╥encoded╙ in MacBinary (.bin) format. This encoding method is commonly used by the online services that are not Internet based. Be aware that MacBinary files may not have the .bin extension as part of the file name, but don't worry because StuffIt Expander can handle these files.  An example of when you would use this feature, is when you download a Macintosh file to your PC, and bring the file to your Macintosh .  
  24.  
  25. You can also configure StuffIt Expander to perform periodic checks on the contents of a specified folder (called a ╥Watch Folder╙), and to expand any new files that it finds. Therefore, you can set StuffIt Expander to expand groups of files in the background while others are being downloaded.
  26.  
  27. If you have also installed ╥DropStuff with Expander Enhancer╙, a separate product, you will then be able to expand files which were compressed or encoded on PCs and Unix systems with StuffIt Expander. These include: ZIP (.zip), and ARC (.arc) archives, gzip (.gz), Unix Compress (.Z), UUencoded (.uu), and Tar (.tar). You will also be able to expand files which were compressed with StuffIt SpaceSaver and join files that were segmented with another StuffIt product. StuffIt Expander cannot expand encrypted or segmented Zip  or Compact Pro files.
  28.  
  29. In addition, if ╥DropStuff with Expander Enhancer╙ has been installed, expansion will occur at accelerated speeds on Power Macintoshes (e.g., expansion of a sample StuffIt archive runs more than 5 times faster on a Power Macintosh 6100/60 than on a IIci).
  30.  
  31. Installation
  32. ------------
  33. Hopefully, you╒re reading this document after the complete software ╥package╙ was installed by the ╥StuffIt Expander Installer╙. If not, you should obtain the ╥StuffIt Expander Installer╙ and reinstall the software.  Refer to the ╥What was installed (and where)╙ document for details on where the software was installed.  This document is located in the Read Us First! folder.
  34.  
  35. Requirements
  36. ------------
  37. StuffIt Expander requires System 6.0.5 or later, and System 7.X users additionally can enjoy an easy ╥drag & drop╙ interface.
  38.  
  39. StuffIt Expander is Apple event aware, 32-bit clean. Expander is also Power Macintosh, AV, ╒040 cache and virtual memory compatible. Expander has an intelligent background processing scheme that makes it perfect for expanding groups of files so that you can continue to do other things with your computer. 
  40.  
  41. DropStuff with Expander Enhancer is a System 7-only shareware product. Be sure to install it with the ╥DropStuff with Expander Enhancer Installer╙ and register your shareware.
  42.  
  43. Using StuffIt Expander
  44. ----------------------
  45. Under System 7, your files can be expanded by dragging those icons onto the StuffIt Expander icon. You may also drag a folder or disk icon over StuffIt Expander, and it will expand any compressed or encoded files within the folder or disk. 
  46. 1. In the Finder, select one or more icons that you want expanded.
  47. 2. Drag them over the StuffIt Expander icon until it is highlighted.
  48. 3. Let go of the mouse/trackball button.
  49. StuffIt Expander will open and you╒ll see a progress dialog. Each archive gets expanded into a new folder, located in the same folder as the archive. 
  50.  
  51. When everything is expanded, StuffIt Expander automatically quits. 
  52.  
  53. System 6 users, or those who prefer a ╥manual╙ way to expand their files, should:
  54. 1. Double click the StuffIt Expander icon.
  55. 2. Choose the ╥Expand╔╙ command from the File menu.
  56. 3. Select the file to be expanded.
  57. 4. Click the ╥Expand╙ button.
  58. A progress dialog will appear as each file gets expanded into the same folder as the original file you specified.
  59. 5. Return to step 2 to expand more files or choose ╥Quit╙ from the File menu to exit StuffIt Expander.
  60.  
  61. Setting up a ╥Watch Folder╙:
  62. 1. Double click the StuffIt Expander icon.
  63. 2. Choose ╥Preferences...╙ from the File menu.
  64. 3. Select the ╥Watch Folder╙ icon from the list on the left.
  65. 4. Check the ╥Check for files to expand in╙ checkbox to enable the feature.
  66. 5. StuffIt Expander will ask you to select the folder you want watched.
  67. 6. Type the number of minutes you want StuffIt Expander to wait before checking the Watch Folder again.
  68. 7. Click ╥OK╙.
  69. 8. Leave StuffIt Expander running, and do other things (such as downloading new files).
  70.  
  71. Special Topics for StuffIt Expander
  72. ===================================
  73.  
  74. Shortcuts
  75. ---------
  76. * If you hold down the Control key when dropping the files on the icon, or when choosing Expand from the menu, StuffIt Expander will delete the original archives after expanding them. You are not warned, so use this feature carefully.
  77. * If you hold down the Option key when dropping the files on the icon, or when choosing Expand from the menu, you will have the option of choosing preferences which will apply only that one time to file expansion, after which StuffIt Expander will go back to using your previously set preferences.
  78. * If you hold down the Command key when choosing ╥Expand...╙ from the File menu, you will be able to select a folder (or entire disk) to expand, instead of a single file. Normally, you should just drop a folder onto StuffIt Expander to accomplish this.
  79. * If you hold down the Shift key when choosing expand from the File menu, and a Watch Folder has been defined, the Watch Folder is scanned for new files to expand.
  80.  
  81. Scripting
  82. ---------
  83. Scripters can control StuffIt Expander from other applications. For example, with HyperCard use the ╥open <document> using ╥StuffIt Expander╙╙ command. With Frontier, use a ╥required.OpenDocument(╘SITx╒, document)╙.
  84.  
  85. Users of AppleScript and Frontier can get more sophisticated control over StuffIt Expander via the ╥Expand╙ event. Use the AppleScript Script Editor╒s ╥Open Dictionary╙ command, and "open" StuffIt Expander to view the information on the Expand event.
  86.  
  87. Caveats
  88. -------
  89. * With the exception of StuffIt 3.X archives, StuffIt Expander will not expand encrypted or password protected archives. 
  90. * StuffIt Expander will not expand StuffIt archives created using 2.0 Optimizers. You will need either the StuffIt Deluxe or the StuffIt Lite application, and the 2.0 optimizer used to compress the archive.
  91.  
  92. Troubleshooting / Known Issues
  93. ------------------------------
  94. * When DropStuff with Expander Enhancer is installed, StuffIt Expander╒s joining feature may not work correctly under certain circumstances. Specifically, if the ╥Delete segments after joining╙ preference is selected, and you run out of disk space during a join operation, the first segment will be deleted even though the joining is not complete. The easy way to avoid this is to make sure you have enough disk space before performing a join, or alternatively deselecting the ╥Delete segments after joining╙ preference.
  95. * If StuffIt Expander does not highlight when dragging a file onto it, try rebuilding your desktop by restarting your computer while holding down the Option and Command keys until a dialog appears. Click ╥OK╙ when asked if you want to rebuild your desktop.
  96. * Dragging a file from a volume on which you do not have ╥change╙ permission onto Expander will result in a -5000 error message. That just means you don╒t have permission to expand there and you should pick a new destination.
  97.  
  98. We hope that you won╒t have any problems with StuffIt Expander, but if you do, you can contact Aladdin Systems. E-mail is the best way to get your technical questions answered.  The Technical Support E-mail address is: tech.assist@aladdinsys.com
  99.  
  100. Contacting Aladdin Systems
  101. ==========================
  102. If you would like information about our other award-winning products (like StuffIt Deluxe, CyberFinder, Aladdin Desktop Tools, or SITcomm), just ask us. For the quickest way to learn more about Aladdin's products visit our Web site listed below.
  103.  
  104. E-mail:
  105.   America Online: Aladdin
  106.   CompuServe: 75300,1666
  107.   Internet: cust.service@aladdinsys.com
  108. Internet Locations:
  109.   Web: http://www.aladdinsys.com
  110.     FTP: ftp://ftp.aladdinsys.com
  111. Address:
  112.  Aladdin Systems, Inc.
  113.  165 Westridge Drive
  114.  Watsonville, CA 95076 USA
  115. Phone:
  116.  408/761-6200
  117. Fax:
  118.  408/761-6206
  119.  
  120. What is Freeware?
  121. =================
  122. Freeware is copyrighted software which never costs anything to use. Like shareware, it may be given out to friends or posted on bulletin boards and online services. But, unlike shareware, you can use it and pay nothing!
  123.  
  124. StuffIt Expander is Freeware.
  125.  
  126. Please share this software with every Mac user you know!
  127.  
  128. But, PLEASE, give away the installer only, not the individual files (i.e. StuffIt Expander¬). 
  129. THANKS!
  130.